home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_game / kzwrd140.zip / SYSOP.DOC < prev    next >
Text File  |  1996-05-04  |  24KB  |  503 lines
  1.                              KROZWORD Version 1.30
  2.  
  3.                         Program & Design by Alan Deala
  4.                            Copyright (C) Alan Deala 1996
  5.  
  6.  
  7.                                   DISCLAIMER
  8.  
  9.         The author has taken every precaution to insure that no harm
  10.         or damage will occur on computer systems operating this package.
  11.         Nevertheless, the author shall NOT be held liable for whatever
  12.         may happen on your computer system or to any computer systems
  13.         which connects to your own as a result of operating this package.
  14.         The user assumes full responsibility for the correct operation of
  15.         this software package, whether harm or damage results from software
  16.         error, hardware malfunction, or operator error. NO warranties are
  17.         offered, expressly stated or implied, including without limitation
  18.         or restriction any warranties of operation for a particular purpose
  19.         and/or merchantability.  If you do not agree with this then do NOT
  20.         use this program.
  21.  
  22.                                 LICENSE AGREEMENT
  23.  
  24.         The game program, support files, and documentation are
  25.         copyrighted products of the AUTHOR.  The AUTHOR reserves all rights
  26.         to these products. This is protected by the United States of America
  27.         (USA) and International Copyright Laws. In no way shall the
  28.         components of the game software package be reproduced
  29.         or modified in any form or method without prior expressly written
  30.         permission from the AUTHOR.
  31.  
  32.         Tampering with or altering the contents or integrity of the game
  33.         software package is prohibited. No fee may be charged by any
  34.         agency other than the AUTHOR beyond the cost of distributing
  35.         unregistered copies without prior expressly written permission from
  36.         the AUTHOR.
  37.  
  38.         The communications portion of this software was written by Scott
  39.         Baker and Steven Lorenz. Mr. Baker's Doordriver kit and the changes
  40.         made by Mr Lorenz have been used for the communications and
  41.         interrupt handling and this part of the software remains
  42.         copyrighted by them.
  43.  
  44.         This game is distributed under the Shareware concept. You are
  45.         allowed to operate this game for a trial period of thirty (30)
  46.         days. After this trial period, you must register the game 
  47.         or discontinue its usage. Again if you do not agree with this
  48.         then do NOT use this game.
  49.  
  50.      
  51.                              INTRODUCTION:
  52.                              ------------
  53.  
  54.  
  55.  Krozword is a game of crossword puzzle competition that ranks players
  56.  on both the accuracy of their answers and on the total number of
  57.  correct answers given. The level of difficulty can be adjusted in
  58.  several ways by the sysop or players. The sysop determines the number
  59.  of chances each player gets to try to answer puzzle clues and whether
  60.  or not a correct guess counts against the total number of guesses a
  61.  player is allowed per day. The sysop (or the players) can further
  62.  adjust the difficulty of the game by putting easy or difficult
  63.  crossword puzzles online.
  64.  
  65.  
  66.                              REQUIREMENTS:
  67.                              ------------
  68.  At this point in time the only requirements are FILES=10 (or more) in your
  69.  config.sys file and ANSI.SYS. SHARE must also be loaded IF you intend to
  70.  use the game in a multi-node environment OR under DesqView. The game is
  71.  RIP aware but NOT a RIP Game at this time. A FOSSIL is NOT required to run
  72.  the game, although one will be supported if it exists. Automatic time
  73.  slicing support is provided to most common multi-taskers as well.
  74.  
  75.                             Files Included
  76.                             --------------
  77.  Below is a listing of all files for the this Game. Feel free to give
  78.  out copies of the ENTIRE archive package of this game but please make
  79.  sure all the files below are in that package:
  80.  
  81.  KROZ.BAT     - A sample BAT file which runs the game program from the
  82.                   game directory.
  83.  LOCAL.BAT    - Batch file for running the game in Local mode
  84.  KROZWORD.CFG - Un-edited sample Control file for setting up Krozword.
  85.                 You MUST edit this to reflect your BBS settings in order
  86.                 for the game to function properly. This is only a
  87.                 template.
  88.  FILE_ID.DIZ  - Ascii Description File for BBS Sysops on Krozword
  89.  HISTORY.DOC  - Krozword Version History information file
  90.  SYSOP.DOC    - This text file you are reading
  91.  UPGRADE.DOC  - Instructions for implementing upgrade to previous version.
  92.  KROZWORD.EXE - Krozword Main Program
  93.  KWPUZZLE.*   - Sample Krozword puzzles
  94.  KROZWORD.HLP - Player instructions for playing Krozword
  95.  KROZASST.ZIP - A program the players can download to make their own
  96.                 Krozword puzzles that they can upload.
  97.  DOWNLOAD.DAT - A list of download transfer protocols (for downloading
  98.                 KROZASST.ZIP).
  99.  SENDX.BAT    - A sample batch file for X-modem downloads
  100.  SENDZ.BAT    - A sample batch file for Z-modem downloads
  101.  PROTOCOL.DAT - A list of upload transfer protocols. Delete or rename
  102.                 this if you do not want to allow users to upload puzzles
  103.                 for other players to solve.
  104.  RECVX.BAT    - A sample batch file for X-modem uploads
  105.  RECVZ.BAT    - A sample batch file for Z-modem uploads
  106.  REGISTER.FRM - Preprinted registration form
  107.  
  108.  
  109.  Files created by the game when first played:
  110.  
  111.  KROZWORD.USR - Player information
  112.  KROZHIGH.ANS - Color ANSI bulletin of high scores
  113.  KROZHIGH.ASC - Plain text ASCII bulletin of high scores
  114.  
  115.  Files created by the game when errors are encountered:
  116.  
  117.  ERROR.LOG    - Log of system errors which happen during game play.
  118.  
  119.                            Installation
  120.                            ------------
  121.  
  122. --> NOTE:  The word "game" is used in place of the program name for
  123.            both the executable file (example KROZWORD.EXE), and the CFG
  124.            file (Example KROZWORD.CFG) in the documentation from this
  125.            point on.  The directory that KROZWORD is installed in will
  126.            herein after be referred to simply as "GAMEDIR".
  127.  
  128.  1. Create a directory for the game (example: "C:\DOORS\KROZWORD")
  129.  
  130.  2. Make sure that ALL files listed above from the game package
  131.     are moved into that directory.
  132.  
  133.  3. Edit you game CFG file (KROZWORD.CFG is included as a sample).
  134.     (see the section below for complete info on all options available for
  135.      the CFG file).
  136.  
  137.  4. Repeat step #3 for each CFG file needed in a multi-node system.
  138.  
  139.  5. To insure proper multi-node use, DOS SHARE must be loaded prior to
  140.      the game and prior to DESQview. (Share should not be required under
  141.      Windows or OS/2).
  142.  
  143.  6. In order to run the game program online the following parameters MAY
  144.      be used.
  145.  
  146.       "/Bxxxxx"   This tells KROZWORD.EXE to lock its baud rate at
  147.       xxxxx.  In order to get the most efficiency out of a high speed
  148.       error correcting modem (9600 baud or above), you may lock the baud
  149.       rate to a speed higher than what the caller is actually using.
  150.       By locking the baud to say 38,400, the modem can compress text data
  151.       that is being sent and achieve a baud rate much higher than the
  152.       actual transmission rate. This will lock the baud rate at the same
  153.       value for all nodes that use this command line.
  154.  
  155.         If you prefer a more selective way to lock baud use the 'LOCKBAUD'
  156.       command in the KROZWORD.CFG file followed by the baud rate.
  157.  
  158.       "/Cx"     (where x is 1..4) This specifies a comport number.
  159.       Some bbs software does not create door information files (dropfiles)
  160.       that contain the comport number.  If your bbs does have a comport
  161.       listed in the dropfile then there is no need for this parameter.
  162.       The default is comport 0, local mode.
  163.  
  164.       "/E" - Expanded Memory Specification If your machine has over one
  165.       megabyte of memory, then you may have some available.  KROZWORD.EXE can
  166.       utilize EMS to improve game performance and reduce conventional
  167.       memory requirements.
  168.       This command will tell KROZWORD.EXE   to use EMS memory to hold its
  169.       overlay buffer.  Otherwise disc area may be used to hold this buffer.
  170.       This needs a memory manager and when enabled and is compatible with
  171.       DESQview.
  172.  
  173.       "/L"      This tells KROZWORD.EXE to load up in LOCAL mode.
  174.       This is good for testing or when a sysop just wants to "try out" the
  175.       door without messing with his BBS setup.  The "/L" mode will ask the
  176.       user for his name and run the door in local mode.
  177.  
  178.       "/Nx"     (where x is 1..9) This specifies a "node number".
  179.       Some bbs software support multinode environments in which you must
  180.       know the node number of the drop file to use. For example, RBBS-PC
  181.       uses DORINFOx.DEF. If you specified "/N2" then KROZWORD.EXE would use
  182.       DORINFO2.DEF.
  183.  
  184.       "/Pyyy"   This specifies the path to the drop files. For example,
  185.       "/PC:\BBS\NODE1" would tell KROZWORD.EXE to look for the drop file
  186.       in C:\BBS\NODE1. If this is left out the program assumes the drop
  187.       file is local.
  188.  
  189.       "/V"    This command will tell KROZWORD.EXE not to show any display
  190.       on the local screen.  Only a colored screen and a message will be
  191.       displayed.  The cursor will not move as it will be turned off.
  192.       Saves a little processing on multi-tasking systems.
  193.  
  194.       "/W"      This flags the program that a network is present even
  195.       though no multitaskers are detected.  This is useful if the door is
  196.       run on a network such as Novell that doesn't use multitaskers.
  197.  
  198.         COMMON ERRORS
  199.         003  File path not found. Check to make sure the game directory is
  200.               correctly named as GAMEDIR.
  201.         201  Files not found. Check to make sure that all required games
  202.               files are in the GAMEDIR directory.
  203.  
  204.  7. Install the door into your BBS software (see your BBS software
  205.     documentation for more information).  A batch file is normally used
  206.     to do this.  To run the program just have your batch file change to
  207.     the GAMEDIR directory and run KROZWORD.EXE followed by the name of
  208.     your CFG file and, optionally, the /P command to tell Krozword where
  209.     to find the drop file - Thats all there is to it!  A batch file
  210.     sample is included to help you run the game. This is included with
  211.     the game for editing and your use.        The following are a couple of
  212.     examples:
  213.  
  214.                             Sample Batch File 1
  215.              (copying the drop file into the KROZWORD directory)
  216.                             -------------------
  217.  
  218.                  COPY DORINFOx.DEF \RBBS\DOORS\KROZWORD\*.*
  219.                  CD \RBBS\DOORS\KROZWORD
  220.                  KROZWORD KROZx.CFG /Nx
  221.                  del DORINFOx.DEF
  222.                  CD \WC30
  223.  
  224.     -=*=- Please note that you replace the "x" with the appropriate node
  225.           number. Ex: Dorinfo1.def ; Dorinfo2.def ; etc...
  226.  
  227.  
  228.                            Sample Batch File 2
  229.                      (leaving the drop file in place)
  230.                            -------------------
  231.                  C:
  232.                  CD \BBS\DOORS\KROZWORD
  233.                  KROZWORD KROZWORD.CFG /PC:\BBS\NODE1
  234.                  CD \BBS
  235.  
  236.  
  237.  
  238.                          THE CFG FILE OPTIONS
  239.                          --------------------
  240.  
  241. The following options can appear in the CFG file in any order. One keyword
  242. can be used per line and all keywords must begin at the start of the line.
  243. "{}" designates required options, "[]" designates optional options,
  244. "|" designates that you should choose ONE of the listed options
  245.  
  246. KEYWORD       OPTIONS                COMMENTS
  247. ------------------------------------------------------------------
  248. SYSOPFIRST    {name}                 Sysop's First Name
  249. SYSOPLAST     {name}                 Sysop's Last Name
  250. BBSNAME       {name}                 BBS Name
  251. BBSTYPE       {bbstype*}             One of the BBS types *(see below)
  252. SYSOPSEC      {number}               Sysop's security level
  253. GUESSES       {number}               Number of guesses allowed per day
  254. COUNTALL      {YES | NO}             Count correct guesses against
  255.                                      total # of guesses allowed per day?
  256. STATUS        {ON | OFF}             Designate status line on or off
  257. FOSSIL                               Force fossil driver on
  258. XFOSSIL                              Force extended fossil driver on
  259. LOCKBAUD      {baudrate}             Lock the baud at the specified rate
  260. PORT1         {port address} {irq}   Specify Com port 1 address & IRQ
  261.                                      (only necessary for non-standard
  262.                                       port settings)
  263. PORT2         {port address} {irq}   Specify Com port 2 address & IRQ
  264. PORT3         {port address} {irq}   Specify Com port 3 address & IRQ
  265. PORT4         {port address} {irq}   Specify Com port 4 address & IRQ
  266. STATFORE      {colornumber}          Foreground color of the status line
  267.                                      (0-15)
  268. STATBACK      {colornumber}          Background color of the status line
  269.                                      (0-7)
  270. MAXTIME       {minutes}              Maximum time allowed in door
  271. COLOR                                Force color mode
  272. MONO                                 Force mono mode
  273. COMPORT       {portnumber}           Force com port #
  274.  
  275. ----------------
  276. BBSTYPES:
  277.  
  278.          OPTION         Comment
  279.          ------         -----------------------------------
  280.          LOCAL          Local mode
  281.          QUICK          Quick BBS (Dorinfox.def)
  282.          PCB12          PCBoard version 1.2 (PCBoard.Sys)
  283.          PCB14          PCBoard version 1.4 (PCBoard.Sys)
  284.          PCB15          PCBoard version 1.5 (PCBoard.Sys)
  285.          WWIV           WWIV (Chain.txt)
  286.          RBBS           RBBS (Dorinfox.def)
  287.          PHOENIX        Phoenix (info.bbs)
  288.          CALLINFO       Wildcat (callinfo.bbs)
  289.          DOORSYS        Generic DOOR.SYS
  290.          SPITFIRE       Spitfire (SFDOORS.DAT)
  291.          2AM            2 A.M. (Jumper.Dat)
  292.          TRIBBS         TriBBS (TriBBS.Sys)
  293.  
  294. ----------------
  295.  
  296.  
  297.                   RESTRICTIONS ON THE UNREGISTERED GAME
  298.                   -------------------------------------
  299.  Until the game is registered the following restrictions are in effect:
  300.  
  301.  a.  There can be only 5 krozword puzzles online at a time to choose
  302.      from.
  303.  
  304.  b.  There will be a slight delay experienced by players at the beginning of
  305.      the game.
  306.  
  307.                      BENEFITS OF A REGISTERED GAME
  308.                      -----------------------------
  309.  
  310.  a.  Virtually unlimited number of puzzles to choose from.
  311.  
  312.  b.  No delay upon entering the game.
  313.  
  314.  c.  Your name (or the name of the user who paid to register the door)
  315.      will show to all the players upon entering the game.
  316.  
  317.  d. You will be able to download and use "Puzzle Packs" from my web
  318.     site that are only available to registered users!
  319.  
  320.  e.  You will be encouraging me to further improve this game and to
  321.      create more quality games like it.
  322.  
  323.  f.  Any future updates are free!
  324.  
  325.                      WHAT TO DO IF THERE ARE PROBLEMS
  326.                      --------------------------------
  327.  
  328.  Every effort is made to ensure that the game runs correctly before it leaves
  329.  my BBS as Shareware. You should read ALL the documents first. If you
  330.  still have a problem or question, you can write to me at any of the
  331.  address listed in the "Where to Reach Me" section below.
  332.  
  333.  
  334.  
  335.                              Multinode use
  336.                              -------------
  337.  This game supports multinode use and provides automatic multi-tasker
  338.  support  (time slice releasing) for a wide variety of multi-taskers.
  339.  
  340.            Common Problems (Locked Bauds, High Speed modems, etc)
  341.            ------------------------------------------------------
  342.  
  343.  1.   The game does NOT require a fossil driver to run.
  344.  
  345.  2.   If you are running a high speed modem (9600 baud or above), then I
  346.       suggest you run your bbs/mailer/doors at a locked baud rate. On high
  347.       speed error correcting modems, locking the baud rate will have a
  348.       noticeable increase on the speed of text that is sent. It's beyond
  349.       the scope of this document to discuss configuring your BBS and
  350.       mailer for a locked baud rate; you may wish to consult those docs
  351.       for information on that. Here are a few things to keep in mind when
  352.       setting up KROZWORD with a locked baud rate:
  353.  
  354.       a.  When using a locked baud rate, I highly recommend using a FOSSIL
  355.           driver. This game will work at high speeds without one though.
  356.           BNU is a good fossil driver which can even be loaded and unloaded
  357.           before and after you run this game.
  358.  
  359.       b.  If you are using a fossil, then make sure to tell the fossil
  360.           that the port is locked. For BNU, to lock com1: at 38,400, you
  361.           would use something like "L0=38400" on BNU's command line.
  362.  
  363.       c.  If you lock the baud for one program, it must be locked
  364.           for everything. You can't lock the baud for just this game, but
  365.           not your BBS/mailer.
  366.  
  367.       d.  You may need to use the /B switch on the KROZWORD.EXE Command line
  368.           to specify the locked baud rate. For 19,200 this would be "/B19200"
  369.           and for 38,400 this would be "/B38400". Please note there is no
  370.           space between the "/B" and the baud rate and there are no
  371.           commas in the speed number.
  372.  
  373.  3.   What follows is some information on possible strange situations
  374.       that may occur:
  375.  
  376.       a.  Low speed users can play the game, but high speed users get
  377.           garbage.
  378.      
  379.           - If you are not using the DORINFOx.DEF or DOOR.SYS drop file
  380.             then you may wish to find a converter program to convert
  381.             whatever drop file your BBS produces to the DORINFOx.DEF
  382.             or DOOR.SYS format and tell KROZWORD.EXE to use that.
  383.  
  384.             Several converter programs are readily available on most
  385.             BBS systems. CallDoor is a good one if you can find it.
  386.  
  387.       b.  The game hangs up when a user enters the game.
  388.  
  389.           - Sounds like the game is getting the wrong baud rate somehow.
  390.             Try switching over to the DOOR.SYS drop file method
  391.             if possible.
  392.  
  393.       c.  Text and screens are getting cut off.
  394.  
  395.           - If you are running with a locked baud, then this could
  396.             be caused by some sort of FLOW CONTROL problem. Try using
  397.             a fossil if you aren't already.
  398.  
  399.       d.  If you're using something other than the DOOR.SYS drop file,
  400.           then I always suggest trying to use DOOR.SYS if possible. It is
  401.           the most reliable method and has had the most testing. If that
  402.           is not possible try DORINFOx.DEF as an alternative.
  403.  
  404.       e.  A door locks up node 1.  This can happen with fossils or the
  405.           internal communications routines because it uses the default
  406.           comport of 1 when NONE is found in the dropfile or KROZWORD.CFG
  407.           file. To correct this make sure the right port is shown in
  408.           the dropfile OR KROZWORD.CFG file.
  409.  
  410.       f.  ANSI is reflected correctly on the local screen but the user
  411.           is getting garbage.  Assuming the user has ANSI installed then
  412.           most likely the problem is at your end. First make sure you
  413.           have configured the KROZWORD.CFG file to show the correct locked
  414.           port rate. Second make sure the dropfile is passing the locked
  415.           port rate INSTEAD of the actual connect rate.  If it is not
  416.           passing the locked port rate then you may need to use a
  417.           different dropfile format OR use a dropfile converter program
  418.           to change the line to show the locked port rate INSTEAD of
  419.           the actual connect rate.
  420.  
  421.                               CREDITS:
  422.                               --------
  423.  This relatively small section is just to recognize the GOOD people
  424.  who have made this DDPLUS based game a possibility.
  425.  
  426.  Alan Deala           -=*=-  The author of Krozwords, who used the combined
  427.                           work of all those listed below to make this
  428.                           game possible.
  429.  
  430.  Vel Selvan           -=*=-  Thanks for your patience! You have undoubtedly
  431. (Beta Tester)                won the prize for finding the most bugs
  432.                              and coming up with the most suggestions that
  433.                              have been incorporated into the game.
  434.  
  435.  8 Baller             -=*=-  The reason why I switched over to DDPLUS
  436. (Beta Tester)                as my door routines of choice! He really
  437.                              found some elusive bugs.
  438.  
  439.  Scott Baker           -=*=-  The authors of the original DoorDriver Kit
  440.  and                       are to be thanked for releasing the
  441.  Derrick Parkhurst           source code to their great kit!
  442.  
  443.  Steven Lorenz      -=*=- The author of the enhanced add on package
  444.                            to Scott Bakers DoorDriver Kit.
  445.  
  446.  Bob Dalton         -=*=- The author of most of the DDPLus documentation
  447.                            and contributor of the MISC.PAS and INITOVER.PAS
  448.                            units used in the game.
  449.  
  450.  DESQview is a registered trademark of Quarterdeck Office Systems.
  451.  Ripscript & Ripterm are registered trademarks of TeleGrafix Communications.
  452.                    
  453.  
  454.                            Where to reach me
  455.                            -----------------
  456.  sirobis@ix.netcom.com
  457.  
  458.  or
  459.  
  460.  http://www.calweb.com/~logon
  461.  
  462.  or
  463.  
  464.  Alan Deala
  465.  P.O. Box 418303
  466.  Sacramento, CA 95841-8303
  467.  
  468.  
  469.                              Registration
  470.                              ------------
  471.  If you or your users enjoy this game, then please register it.
  472.  Registration is only $5.00 and you get a key code by mail which will
  473.  disable the delay, allow players to have more choices, and entitle
  474.  youo to unlimited free updates and upgrades (not like some door game
  475.  authors who charge for major upgrades/updates!) through my web site.
  476.  To register this game just print out the registration form
  477.  (REGISTER.FRM) file included with the game and  send it with your
  478.  check or money order for $5.00 made payable to "Alan Deala" to:
  479.  
  480.                        Alan Deala
  481.                        PO Box 418303
  482.                        Sacramento, CA 95841-8303
  483.  
  484.  
  485.  Reminder: You will be mailed a LETTER (or e-mail) with your
  486.  registration code. Just allow an appropriate amount of time (a week
  487.  or two) after dropping your check in the mail for it to arrive to me
  488.  and the code to be sent by mail back to you. If you live in NORTH
  489.  AMERICA I can also send your key via Netmail, if you would like,
  490.  through the FIDO system. You can also choose the option of having it
  491.  sent via Internet e-mail.  REMINDER: No disks are sent, if you need
  492.  the most current version you must visit my web site.
  493.  
  494.                    Bug Reports/Comments/Suggestions
  495.                    --------------------------------
  496.  I have made every attempt to make sure the game is free of bugs, BUT the
  497.  possibility always exists that one may have been missed by me or the
  498.  playtesters.  If you find a bug, or have a suggestion or comment to make
  499.  which would make future versions better please send it to me at one of
  500.  the address listed above.  I read ALL of them and those people
  501.  that lead me to find a bug or generate a better game will receive credit in
  502.  the game documentation. 
  503.